home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr09 / famsor23.zip / FAMSOR23.DOC < prev    next >
Text File  |  1993-06-13  |  9KB  |  173 lines
  1.                          FAMSOR23.DOC  
  2.   
  3. FAMILY SORT PROGRAMS (FAMSOR.BAT, FAMCFG.EXE, FAMSOR23.EXE, 
  4. FAMPRT23.EXE) Version 2.3 January 1990 - By L. M. Rayburn,  
  5. 2519 E. Meredith Drive, Vienna, VA.  22181, (703)281-4030  
  6.   
  7. QUICK START:  
  8.      To run these programs the following procedure is suggested:
  9.  
  10.      1.   Boot your computer and type A: (Make drive A default) 
  11.  
  12.      2.   Place in drive A: a disk that contains  
  13.           FAMSOR23.EXE, FAMPRT23.EXE, FAMCFG.EXE, 
  14.           FAMSOR.BAT SORTF.EXE, and YESNO.COM. (Of course, these 
  15.       can be run from any subdirectory on your hard disk, but
  16.       should all be in the same subdirectory.)   
  17.  
  18.      3.   If you have a dual floppy system, place in drive B: a 
  19. disk containing the PAF data files listed in the introduction below. 
  20. (If you have a hard disk, you will not need to complete this step.)  
  21.  
  22.      4.   At the A> type FAMCFG and that will start the 
  23. configuration program.  Answer all the questions.  When the prompt
  24. says you have completed the configuration, then:  
  25.  
  26.      5.   Type FAMSOR.  The file FAMSOR.BAT (written during configur-
  27. ation will call the other programs as they are required.  The menus 
  28. will allow you to select the reports which you wish to print.
  29.  
  30.                       -------/-------
  31.   
  32. INTRODUCTION:
  33.  
  34.      The reports which can be printed from the Personal Ancestral
  35. File, Release, 2.0 through 2.2 ((c) by The Church of Christ of 
  36. Latter-day Saints) are generally well concieved and executed.  
  37. However, when printed indexes are required, they are not always 
  38. ideal.  An example is the MRIN sort which produces a listing of 
  39. families (husband and wife with other pertinent data) which lists
  40. the families in MRIN order and the listing is by given name first. 
  41. After the list grows to considerable size it is difficult to locate
  42. individuals.  The programs accompanying this document were created
  43. to work with the data files created by the Personal Ancestral File,
  44. to produce alphabetical listings of families arranged with the 
  45. surname first, and sorted by either MRIN, soundex code, husband 
  46. name, or wife name.  It should be noted that "blank" names sort ahead
  47. of all others, so you may have a page or more before the "a's" start.
  48. The FAMSOR package consists of these files:
  49.  
  50.      FAMSOR.BAT (dummy included, written when FAMCFG.EXE is run),
  51.      PRNTDOC.EXE Program to format and print FAMSOR23.DOC
  52.      FAMPRT23.EXE The program that prints the reports  
  53.      FAMSOR23.EXE The main program that accesses and extracts data
  54.      FAMCFG.EXE A configuration program (run prior to running FAMSOR23)  
  55.      FAMSOR23.CFG, (Not included, but written by FAMCFG.EXE)  
  56.      FAMSOR23.DOC This documentation file  
  57.      SORTF.EXE (a public domain sort utility)
  58.      YESNO.COM A very short file used with FAMSOR.BAT to allow query.
  59.     
  60.      FAMSOR23.EXE reads the data from the PAF files and creates a serial
  61. file called NUMSOR.DAT which is sorted in MRIN order. FAMSOR will call 
  62. FAMPRT23 to print this file if you request a MRIN sort.  The report is
  63. much like the MRIN sorted file printed by the regular program except 
  64. that the names are listed surname first.  From NUMSOR.DAT, SORTF is used 
  65. to create the additional files HUSSOR.DAT, WIFSOR.DAT, or SNDSOR.DAT as 
  66. required and chosen from the FAMPRT23 menu.  These files are sorted
  67. by husband name, wife name, and soundex code respectively.  Any or all 
  68. of these may be printed using FAMSOR.BAT to call FAMPRT23.EXE to create 
  69. separate reports of each file. The batch file (FAMSOR.BAT) created
  70. by the configuration program FAMCFG.EXE is used to coordinate 
  71. operations in one routine.  
  72.  
  73.      FAMSOR23.EXE accesses the data files created by the Personal 
  74. Ancestral File.  The PAF data files required are:  
  75.   
  76.      INDIV2.DAT  
  77.      MARR2.DAT  
  78.      NAME2.DAT  
  79.      REPTITL2.DAT  
  80.   
  81. The FAMSOR programs are not configured when distributed, and 
  82. FAMCFG.EXE must be run to configure the program so that the data
  83. files can be located and the output files written to the desired 
  84. drive[and subdirectory].  FAMCFG.EXE will create FAMSOR.CFG, a file 
  85. which contains the configuration information.  FAMSOR.BAT, the 
  86. control file, will manage the entire sorting and printing process.  
  87.   
  88.      Unlike previous versions of this program, BASIC is not 
  89. required.  You will not need to make any modifications to the 
  90. programs themselves, but you will need to run FAMCFG to set up
  91. your particular drive and printer configuration, and to make certain
  92. selection of options.  
  93.   
  94.      The initial step is to run FAMCFG.EXE by placing the disk in
  95. A:  and typing FAMCFG at the command line.  The configuration 
  96. program will request the drive and path (if any) of where the data
  97. files are located.  (e.g. C:\PAF) No provision has been made for
  98. the data files to be on distributed on different drives.  The 
  99. program can be run from any drive or subdirectory, but all the 
  100. FAMSOR files should be on the same drive and subdirectory. 
  101. The configuration program will then ask what drive [and path] 
  102. will be used for the temporary output files.  A RAM disk is 
  103. valuable for this application, but any drive\directory that has
  104. about 200K space for each thousand families will be okay.  The 
  105. print program requires 17 pitch (condensed print) for 8 1/2 x 11
  106. paper so the configuration program will ask for the printer command
  107. for 17 pitch.  This command must be recognized by YOUR printer.  Then
  108. the command to return to 10 pitch will be requested.  The printer
  109. "reset" command can be used for this application if desired.  If 
  110. you have an EPSON-compatible printer, you can select an option to 
  111. use the dafault EPSON values.  Otherwise you must consult your 
  112. printer manual to determine these commands. (If you don't understand 
  113. printer commands, try selecting the EPSON defaults.  Many printers can 
  114. emulate the EPSON and it probably will work okay.  If it doesn't
  115. print correctly, then you can consult someone who can read the data
  116. in your printer manual). The configuration program allows up to 
  117. three ASCII values for each of these commands, so if your printer
  118. should require ESCAPE "M" which is only two characters, you would
  119. input 27 and 77.  Note that these are the decimal ASCII values for
  120. ESC and "M".  An abbreviated ASCII table is printed at the bottom
  121. of this file for your use, and more complete ones are contained in
  122. most printer manuals.  
  123.  
  124. Notes:  
  125.      This program has been prepared using GWBASIC compiler and an
  126. EVEREX Step 386 Computer, but should work on any IBM compatible.
  127.  
  128.      This program is copyright 1989 by L. M. Rayburn and is offered
  129. for personal use and is not authorized to be sold in any form or
  130. bundled with software that is sold, without permission.  Specific
  131. permission is given to include the FAMSOR programs on disks which
  132. are distributed at nominal charge to cover the cost of copying and 
  133. distributing if the price does not exceed five dollars per disk.  
  134.   
  135. L.   M. Rayburn, 2519 E. Meredith Drive, Vienna, VA., 22181 
  136. (703)281-4030 17 January 1990.  
  137.   
  138. ASCII Table:  
  139.   
  140. Dec  ASCII     Dec  ASCII     Dec  ASCII     Dec  ASCII  
  141. 00   NUL       32   SP        64   @         96   `  
  142. 01   SOH       33   !         65   A         97   a  
  143. 02   STX       34   "         66   B         98   b  
  144. 03   ETX       35   #         67   C         99   c  
  145. 04   EOT       36   $         68   D         100  d  
  146. 05   ENQ       37   %         69   E         101  e  
  147. 06   ACK       38   &         70   F         102  f  
  148. 07   BEL       39   '         71   G         103  g  
  149. 08   BS        40   (         72   H         104  h  
  150. 09   HT        41   )         73   I         105  i  
  151. 10   LF        42   *         74   J         106  j  
  152. 11   VT        43   +         75   K         107  k  
  153. 12   FF        44   ,         76   L         108  l  
  154. 13   CR        45   -         77   M         109  m  
  155. 14   SO        46   .         78   N         110  n  
  156. 15   SI        47   /         79   O         111  o  
  157. 16   DLE       48   0         80   P         112  p  
  158. 17   DC1       49   1         81   Q         113  q  
  159. 18   DC2       50   2         82   R         114  r  
  160. 19   DC3       51   3         83   S         115  s  
  161. 20   DC4       52   4         84   T         116  t  
  162. 21   NAK       53   5         85   U         117  u  
  163. 22   SYN       54   6         86   V         118  v  
  164. 23   ETB       55   7         87   W         119  w  
  165. 24   CAN       56   8         88   X         120  x  
  166. 25   EM        57   9         89   Y         121  y  
  167. 26   SUB       58   :         90   Z         122  z  
  168. 27   ESC       59   ;         91   [         123  {  
  169. 28   FS        60   <         92   \         124  |  
  170. 29   GS        61   =         93   ]         125  }  
  171. 30   RS        62   >         94   ^         126  ~  
  172. 31   US        63   ?         95   _         127  DEL  
  173.